<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 transitional//EN">
<html>
<head>
<title>Cell Element (Eclipse BIRT ROM Documentation)</title>
<link rel="stylesheet" href="../style/style.css" type="text/css"/>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body>
<p class="title">Eclipse BIRT Report Object Model (ROM)</p>
<p class="subtitle">Cell Element</p>
<h1>Element Overview</h1>
<div class="section-text">
Represents a cell element within a grid row or table row.</div>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Display Name:</td>
<td>Cell</td></tr>
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>XML Element:</td>
<td><code>cell</code></td></tr>
<tr><td>Extends:</td>
<td>None</td></tr>
<tr><td>Extendable:</td>
<td>No</td></tr>
<tr><td>Abstract:</td>
<td>No</td></tr>
<tr><td>Name Space:</td>
<td>None</td></tr>
<tr><td>Name Requirement:</td>
<td>Not Supported</td></tr>
<tr><td>Allows User Properties:</td>
<td>Yes</td></tr>
<tr><td>Has Style:</td>
<td>Yes</td></tr>
<tr><td>Default Style:</td>
<td>None</td></tr>
</table>

<h3>Property Summary</h3>

<dl class="section-text">
<dt><a href="#Property-antidiagonalColor">antidiagonalColor</a></dt>
<dd></dd>
<dt><a href="#Property-antidiagonalNumber">antidiagonalNumber</a></dt>
<dd></dd>
<dt><a href="#Property-antidiagonalStyle">antidiagonalStyle</a></dt>
<dd></dd>
<dt><a href="#Property-antidiagonalThickness">antidiagonalThickness</a></dt>
<dd></dd>
<dt><a href="#Property-bookmark">bookmark</a></dt>
<dd></dd>
<dt><a href="#Property-bookmarkDisplayName">bookmarkDisplayName</a></dt>
<dd></dd>
<dt><a href="#Property-colSpan">colSpan</a></dt>
<dd>The number of columns that this cell spans.</dd>
<dt><a href="#Property-column">column</a></dt>
<dd>The column in which the cell starts.</dd>
<dt><a href="#Property-diagonalColor">diagonalColor</a></dt>
<dd></dd>
<dt><a href="#Property-diagonalNumber">diagonalNumber</a></dt>
<dd></dd>
<dt><a href="#Property-diagonalStyle">diagonalStyle</a></dt>
<dd></dd>
<dt><a href="#Property-diagonalThickness">diagonalThickness</a></dt>
<dd></dd>
<dt><a href="#Property-drop">drop</a></dt>
<dd>Whether the cells defined in this row should expand to fill the entire table or group.</dd>
<dt><a href="#Property-eventHandlerClass">eventHandlerClass</a></dt>
<dd>The full qulified name of the event handler class.</dd>
<dt><a href="#Property-headers">headers</a></dt>
<dd></dd>
<dt><a href="#Property-height">height</a></dt>
<dd>Minimum cell height.</dd>
<dt><a href="#Property-newHandlerOnEachEvent">newHandlerOnEachEvent</a></dt>
<dd></dd>
<dt><a href="#Property-rowSpan">rowSpan</a></dt>
<dd>The number of rows that this cell spans.</dd>
<dt><a href="#Property-scope">scope</a></dt>
<dd></dd>
<dt><a href="#Property-style">style</a></dt>
<dd>Name of the style applied to this cell.</dd>
<dt><a href="#Property-viewAction">viewAction</a></dt>
<dd></dd>
<dt><a href="#Property-width">width</a></dt>
<dd>Minimum cell width.</dd>
</dl>

<h3>Method Summary</h3>

<dl class="section-text">
<dt><a href="#Method-onCreate">onCreate</a></dt>
<dd>Script executed when the element is created in the Factory.</dd>
<dt><a href="#Method-onPrepare">onPrepare</a></dt>
<dd>It is for a script startup phase. No data binding yet. The design of an element can be changed here.</dd>
<dt><a href="#Method-onRender">onRender</a></dt>
<dd>Script executed when the element is prepared for rendering in the Presentation engine.</dd>
</dl>

<h3>Slot Summary</h3>

<dl class="section-text">
<dt><a href="#Slot-content">content</a></dt>
<dd>Report items that appear inside the cell.</dd>
</dl>

<h3>Style Properties</h3>

<p class="section-text">
<a href="Style.html#Property-backgroundAttachment">backgroundAttachment</a>, 
<a href="Style.html#Property-backgroundColor">backgroundColor</a>, 
<a href="Style.html#Property-backgroundImage">backgroundImage</a>, 
<a href="Style.html#Property-backgroundPositionX">backgroundPositionX</a>, 
<a href="Style.html#Property-backgroundPositionY">backgroundPositionY</a>, 
<a href="Style.html#Property-backgroundRepeat">backgroundRepeat</a>, 
<a href="Style.html#Property-backgroundSizeHeight">backgroundSizeHeight</a>, 
<a href="Style.html#Property-backgroundSizeWidth">backgroundSizeWidth</a>, 
<a href="Style.html#Property-bidiTextDirection">bidiTextDirection</a>, 
<a href="Style.html#Property-borderBottomColor">borderBottomColor</a>, 
<a href="Style.html#Property-borderBottomStyle">borderBottomStyle</a>, 
<a href="Style.html#Property-borderBottomWidth">borderBottomWidth</a>, 
<a href="Style.html#Property-borderLeftColor">borderLeftColor</a>, 
<a href="Style.html#Property-borderLeftStyle">borderLeftStyle</a>, 
<a href="Style.html#Property-borderLeftWidth">borderLeftWidth</a>, 
<a href="Style.html#Property-borderRightColor">borderRightColor</a>, 
<a href="Style.html#Property-borderRightStyle">borderRightStyle</a>, 
<a href="Style.html#Property-borderRightWidth">borderRightWidth</a>, 
<a href="Style.html#Property-borderTopColor">borderTopColor</a>, 
<a href="Style.html#Property-borderTopStyle">borderTopStyle</a>, 
<a href="Style.html#Property-borderTopWidth">borderTopWidth</a>, 
<a href="Style.html#Property-canShrink">canShrink</a>, 
<a href="Style.html#Property-color">color</a>, 
<a href="Style.html#Property-dateFormat">dateFormat</a>, 
<a href="Style.html#Property-dateTimeFormat">dateTimeFormat</a>, 
<a href="Style.html#Property-display">display</a>, 
<a href="Style.html#Property-fontFamily">fontFamily</a>, 
<a href="Style.html#Property-fontSize">fontSize</a>, 
<a href="Style.html#Property-fontStyle">fontStyle</a>, 
<a href="Style.html#Property-fontVariant">fontVariant</a>, 
<a href="Style.html#Property-fontWeight">fontWeight</a>, 
<a href="Style.html#Property-highlightRules">highlightRules</a>, 
<a href="Style.html#Property-letterSpacing">letterSpacing</a>, 
<a href="Style.html#Property-lineHeight">lineHeight</a>, 
<a href="Style.html#Property-mapRules">mapRules</a>, 
<a href="Style.html#Property-marginBottom">marginBottom</a>, 
<a href="Style.html#Property-marginLeft">marginLeft</a>, 
<a href="Style.html#Property-marginRight">marginRight</a>, 
<a href="Style.html#Property-marginTop">marginTop</a>, 
<a href="Style.html#Property-masterPage">masterPage</a>, 
<a href="Style.html#Property-numberAlign">numberAlign</a>, 
<a href="Style.html#Property-numberFormat">numberFormat</a>, 
<a href="Style.html#Property-orphans">orphans</a>, 
<a href="Style.html#Property-paddingBottom">paddingBottom</a>, 
<a href="Style.html#Property-paddingLeft">paddingLeft</a>, 
<a href="Style.html#Property-paddingRight">paddingRight</a>, 
<a href="Style.html#Property-paddingTop">paddingTop</a>, 
<a href="Style.html#Property-pageBreakAfter">pageBreakAfter</a>, 
<a href="Style.html#Property-pageBreakBefore">pageBreakBefore</a>, 
<a href="Style.html#Property-pageBreakInside">pageBreakInside</a>, 
<a href="Style.html#Property-showIfBlank">showIfBlank</a>, 
<a href="Style.html#Property-stringFormat">stringFormat</a>, 
<a href="Style.html#Property-textAlign">textAlign</a>, 
<a href="Style.html#Property-textIndent">textIndent</a>, 
<a href="Style.html#Property-textLineThrough">textLineThrough</a>, 
<a href="Style.html#Property-textOverline">textOverline</a>, 
<a href="Style.html#Property-textTransform">textTransform</a>, 
<a href="Style.html#Property-textUnderline">textUnderline</a>, 
<a href="Style.html#Property-timeFormat">timeFormat</a>, 
<a href="Style.html#Property-verticalAlign">verticalAlign</a>, 
<a href="Style.html#Property-whiteSpace">whiteSpace</a>, 
<a href="Style.html#Property-widows">widows</a>, 
<a href="Style.html#Property-wordSpacing">wordSpacing</a>
</p>
<h3>Description</h3>

<div class="section-text">
<p>Each grid or table row contains some number of cells. A 
cell can span multiple columns. The design need not specify a cell for each 
column; columns without cells are presumed empty.</p>
<p>If the cell contains more than one item, the items appear 
vertically within the cell. The developer should generally use a container to 
better control the positioning of items when the cell contains multiple items.</p>
<p>The cell height and width are optional and are seldom 
needed. However, they are available for situations where it is required to force 
a cell to a particular size.</p></div>
<h1>Property Detail</h1>

<h2><a name="Property-antidiagonalColor">antidiagonalColor Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#color">color</a></td></tr>
<tr><td>Since:</td>
<td>2.5</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Antidiagonal color</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>black</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>Yes</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Hidden</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Diagonal</td></tr>
</table>

<h3>Choices</h3>

<table class="section-table">
<thead><tr><td>Name</td><td>Display Name</td>
<td>Value</td><td>Description</td></tr></thead>
<tbody>
<tr><td>maroon</td>
<td>Maroon</td>
<td>maroon</td>
<td></td></tr>
<tr><td>red</td>
<td>Red</td>
<td>red</td>
<td></td></tr>
<tr><td>orange</td>
<td>Orange</td>
<td>orange</td>
<td></td></tr>
<tr><td>yellow</td>
<td>Yellow</td>
<td>yellow</td>
<td></td></tr>
<tr><td>olive</td>
<td>Olive</td>
<td>olive</td>
<td></td></tr>
<tr><td>purple</td>
<td>Purple</td>
<td>purple</td>
<td></td></tr>
<tr><td>fuchsia</td>
<td>Fuchsia</td>
<td>fuchsia</td>
<td></td></tr>
<tr><td>white</td>
<td>White</td>
<td>white</td>
<td></td></tr>
<tr><td>lime</td>
<td>Lime</td>
<td>lime</td>
<td></td></tr>
<tr><td>green</td>
<td>Green</td>
<td>green</td>
<td></td></tr>
<tr><td>navy</td>
<td>Navy</td>
<td>navy</td>
<td></td></tr>
<tr><td>blue</td>
<td>Blue</td>
<td>blue</td>
<td></td></tr>
<tr><td>aqua</td>
<td>Aqua</td>
<td>aqua</td>
<td></td></tr>
<tr><td>teal</td>
<td>Teal</td>
<td>teal</td>
<td></td></tr>
<tr><td>black</td>
<td>Black</td>
<td>black</td>
<td></td></tr>
<tr><td>silver</td>
<td>Silver</td>
<td>silver</td>
<td></td></tr>
<tr><td>gray</td>
<td>Gray</td>
<td>gray</td>
<td></td></tr>
</tbody></table><br>

<hr>
<h2><a name="Property-antidiagonalNumber">antidiagonalNumber Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#integer">integer</a></td></tr>
<tr><td>Since:</td>
<td>2.3</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Antidiagonal number</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>0</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Hidden</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Diagonal</td></tr>
</table>


<hr>
<h2><a name="Property-antidiagonalStyle">antidiagonalStyle Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#choice">choice</a> (lineStyle)</td></tr>
<tr><td>Since:</td>
<td>3.2</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Antidiagonal style</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>none</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Hidden</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Diagonal</td></tr>
</table>

<h3>Choices</h3>

<table class="section-table">
<thead><tr><td>Name</td><td>Display Name</td>
<td>Value</td><td>Description</td></tr></thead>
<tbody>
<tr><td>none</td>
<td>No Line Style</td>
<td>none</td>
<td></td></tr>
<tr><td>solid</td>
<td>Solid</td>
<td>solid</td>
<td></td></tr>
<tr><td>dotted</td>
<td>Dotted</td>
<td>dotted</td>
<td></td></tr>
<tr><td>dashed</td>
<td>Dashed</td>
<td>dashed</td>
<td></td></tr>
<tr><td>double</td>
<td>Double</td>
<td>double</td>
<td></td></tr>
<tr><td>groove</td>
<td>Groove</td>
<td>groove</td>
<td></td></tr>
<tr><td>ridge</td>
<td>Ridge</td>
<td>ridge</td>
<td></td></tr>
<tr><td>inset</td>
<td>Inset</td>
<td>inset</td>
<td></td></tr>
<tr><td>outset</td>
<td>Outset</td>
<td>outset</td>
<td></td></tr>
</tbody></table><br>

<hr>
<h2><a name="Property-antidiagonalThickness">antidiagonalThickness Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#dimension">dimension</a></td></tr>
<tr><td>Since:</td>
<td>3.2</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Antidiagonal thickness</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>medium</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Hidden</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Diagonal</td></tr>
</table>

<h3>Choices</h3>

<table class="section-table">
<thead><tr><td>Name</td><td>Display Name</td>
<td>Value</td><td>Description</td></tr></thead>
<tbody>
<tr><td>thin</td>
<td>Thin</td>
<td>thin</td>
<td></td></tr>
<tr><td>medium</td>
<td>Medium</td>
<td>medium</td>
<td></td></tr>
<tr><td>thick</td>
<td>Thick</td>
<td>thick</td>
<td></td></tr>
</tbody></table><br>

<hr>
<h2><a name="Property-bookmark">bookmark Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#expression">expression</a></td></tr>
<tr><td>Context:</td>
<td></td></tr>
<tr><td>Expression Type:</td>
<td>string</td></tr>
<tr><td>Since:</td>
<td>2.5</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Bookmark</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>None</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>


<hr>
<h2><a name="Property-bookmarkDisplayName">bookmarkDisplayName Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#string">string</a></td></tr>
<tr><td>Since:</td>
<td>2.5</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Bookmark display name</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>None</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>


<hr>
<h2><a name="Property-colSpan">colSpan Property</a></h2>

<p class="section-text">The number of columns that this cell spans.</p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#integer">integer</a></td></tr>
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Column span</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>1</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Read-only</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p><p>The number of columns that this cell spans. Defaults 1 
one, meaning that the cell appears in only one column.</p></p></div>

<hr>
<h2><a name="Property-column">column Property</a></h2>

<p class="section-text">The column in which the cell starts.</p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#integer">integer</a></td></tr>
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Column</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>One after the previous column.</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Hidden</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p><p>The column in which the cell starts. Columns are numbered 
from 1.</p>
</p></div>

<hr>
<h2><a name="Property-diagonalColor">diagonalColor Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#color">color</a></td></tr>
<tr><td>Since:</td>
<td>2.5</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Diagonal color</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>black</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>Yes</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Diagonal</td></tr>
</table>

<h3>Choices</h3>

<table class="section-table">
<thead><tr><td>Name</td><td>Display Name</td>
<td>Value</td><td>Description</td></tr></thead>
<tbody>
<tr><td>maroon</td>
<td>Maroon</td>
<td>maroon</td>
<td></td></tr>
<tr><td>red</td>
<td>Red</td>
<td>red</td>
<td></td></tr>
<tr><td>orange</td>
<td>Orange</td>
<td>orange</td>
<td></td></tr>
<tr><td>yellow</td>
<td>Yellow</td>
<td>yellow</td>
<td></td></tr>
<tr><td>olive</td>
<td>Olive</td>
<td>olive</td>
<td></td></tr>
<tr><td>purple</td>
<td>Purple</td>
<td>purple</td>
<td></td></tr>
<tr><td>fuchsia</td>
<td>Fuchsia</td>
<td>fuchsia</td>
<td></td></tr>
<tr><td>white</td>
<td>White</td>
<td>white</td>
<td></td></tr>
<tr><td>lime</td>
<td>Lime</td>
<td>lime</td>
<td></td></tr>
<tr><td>green</td>
<td>Green</td>
<td>green</td>
<td></td></tr>
<tr><td>navy</td>
<td>Navy</td>
<td>navy</td>
<td></td></tr>
<tr><td>blue</td>
<td>Blue</td>
<td>blue</td>
<td></td></tr>
<tr><td>aqua</td>
<td>Aqua</td>
<td>aqua</td>
<td></td></tr>
<tr><td>teal</td>
<td>Teal</td>
<td>teal</td>
<td></td></tr>
<tr><td>black</td>
<td>Black</td>
<td>black</td>
<td></td></tr>
<tr><td>silver</td>
<td>Silver</td>
<td>silver</td>
<td></td></tr>
<tr><td>gray</td>
<td>Gray</td>
<td>gray</td>
<td></td></tr>
</tbody></table><br>

<hr>
<h2><a name="Property-diagonalNumber">diagonalNumber Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#integer">integer</a></td></tr>
<tr><td>Since:</td>
<td>2.3</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Diagonal number</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>0</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Diagonal</td></tr>
</table>


<hr>
<h2><a name="Property-diagonalStyle">diagonalStyle Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#choice">choice</a> (lineStyle)</td></tr>
<tr><td>Since:</td>
<td>3.2</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Diagonal style</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>none</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Diagonal</td></tr>
</table>

<h3>Choices</h3>

<table class="section-table">
<thead><tr><td>Name</td><td>Display Name</td>
<td>Value</td><td>Description</td></tr></thead>
<tbody>
<tr><td>none</td>
<td>No Line Style</td>
<td>none</td>
<td></td></tr>
<tr><td>solid</td>
<td>Solid</td>
<td>solid</td>
<td></td></tr>
<tr><td>dotted</td>
<td>Dotted</td>
<td>dotted</td>
<td></td></tr>
<tr><td>dashed</td>
<td>Dashed</td>
<td>dashed</td>
<td></td></tr>
<tr><td>double</td>
<td>Double</td>
<td>double</td>
<td></td></tr>
<tr><td>groove</td>
<td>Groove</td>
<td>groove</td>
<td></td></tr>
<tr><td>ridge</td>
<td>Ridge</td>
<td>ridge</td>
<td></td></tr>
<tr><td>inset</td>
<td>Inset</td>
<td>inset</td>
<td></td></tr>
<tr><td>outset</td>
<td>Outset</td>
<td>outset</td>
<td></td></tr>
</tbody></table><br>

<hr>
<h2><a name="Property-diagonalThickness">diagonalThickness Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#dimension">dimension</a></td></tr>
<tr><td>Since:</td>
<td>3.2</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Diagonal thickness</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>medium</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Diagonal</td></tr>
</table>

<h3>Choices</h3>

<table class="section-table">
<thead><tr><td>Name</td><td>Display Name</td>
<td>Value</td><td>Description</td></tr></thead>
<tbody>
<tr><td>thin</td>
<td>Thin</td>
<td>thin</td>
<td></td></tr>
<tr><td>medium</td>
<td>Medium</td>
<td>medium</td>
<td></td></tr>
<tr><td>thick</td>
<td>Thick</td>
<td>thick</td>
<td></td></tr>
</tbody></table><br>

<hr>
<h2><a name="Property-drop">drop Property</a></h2>

<p class="section-text">Whether the cells defined in this row should expand to fill the entire table or group.</p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#choice">choice</a> (dropType)</td></tr>
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Drop</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>none</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>

<h3>Choices</h3>

<table class="section-table">
<thead><tr><td>Name</td><td>Display Name</td>
<td>Value</td><td>Description</td></tr></thead>
<tbody>
<tr><td>none</td>
<td>None</td>
<td>none</td>
<td>No drop header is created.</td></tr>
<tr><td>detail</td>
<td>Detail</td>
<td>detail</td>
<td>The header is merged 
    with the cells of the detail rows, but not footer rows.</td></tr>
<tr><td>all</td>
<td>All</td>
<td>all</td>
<td>The header is merged 
    with the cells of the detail rows and footer rows.</td></tr>
</tbody></table><br>
<h3>Description</h3>

<div class="section-text">
<p><p>Whether the cells defined in this row should expand to 
fill the entire table or group. Allows creating a &quot;drop&quot; header within a table. 
See explanation in the <i>ROM List and Table Specification</i>. Ignored for 
grids, and for cells that are not in group headers.</p></p></div>

<hr>
<h2><a name="Property-eventHandlerClass">eventHandlerClass Property</a></h2>

<p class="section-text">The full qulified name of the event handler class.</p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#string">string</a></td></tr>
<tr><td>Since:</td>
<td>2.0</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Event handler class</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>None</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>Yes</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p>Full quilified name of the event handler class, used to specify an external Java class
which define the scripting behavior that will be executed at runtime.</p></div>

<hr>
<h2><a name="Property-headers">headers Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#expression">expression</a></td></tr>
<tr><td>Context:</td>
<td></td></tr>
<tr><td>Expression Type:</td>
<td>string</td></tr>
<tr><td>Since:</td>
<td>2.5</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Headers</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>None</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>


<hr>
<h2><a name="Property-height">height Property</a></h2>

<p class="section-text">Minimum cell height.</p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#dimension">dimension</a></td></tr>
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Height</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>The height is automatically sized to its 
content.</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p><p>Minimum cell height. Generally omitted. The size of the 
cell is the minimum of the height of its contents and the minimum cell height. 
The final cell height is set by the overall row.</p>
<p>A better practice is to set the height of the row instead the height of a 
cell.</p>
</p></div>

<hr>
<h2><a name="Property-newHandlerOnEachEvent">newHandlerOnEachEvent Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#boolean">boolean</a></td></tr>
<tr><td>Since:</td>
<td>2.5</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>New handler on each event</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>false</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>Yes</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>


<hr>
<h2><a name="Property-rowSpan">rowSpan Property</a></h2>

<p class="section-text">The number of rows that this cell spans.</p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#integer">integer</a></td></tr>
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Row span</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>1</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Read-only</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p><p>The number of rows that this cell spans. Defaults to 1, meaning the cell 
appears in only one row.</p></p></div>

<hr>
<h2><a name="Property-scope">scope Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#choice">choice</a> (scopeType)</td></tr>
<tr><td>Since:</td>
<td>2.5</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Scope</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>None</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>

<h3>Choices</h3>

<table class="section-table">
<thead><tr><td>Name</td><td>Display Name</td>
<td>Value</td><td>Description</td></tr></thead>
<tbody>
<tr><td>row</td>
<td>Row</td>
<td>row</td>
<td></td></tr>
<tr><td>col</td>
<td>Column</td>
<td>col</td>
<td></td></tr>
<tr><td>rowgroup</td>
<td>Row Group</td>
<td>rowgroup</td>
<td></td></tr>
<tr><td>colgroup</td>
<td>Column Group</td>
<td>colgroup</td>
<td></td></tr>
</tbody></table><br>

<hr>
<h2><a name="Property-style">style Property</a></h2>

<p class="section-text">Name of the style applied to this cell.</p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../elements/Style.html">Style</a> Reference</td></tr>
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Style</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>None</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p><p>Rows provide many style properties. The style properties are defined in 
the <i>ROM Styles Specification</i>. A cell can inherit its style properties 
from a parent element, from a named style, or from a style that identifies the 
context in which the item appears. This property provides the name of the shared 
style to use.</p>
<p>This cell can also set the value of style properties. Properties set on this 
element &quot;override&quot; those inherited from a parent element or a shared style.</p></p></div>
<h3>See Also</h3>

<div class="section-text">
<p>Style element in the <i>ROM Styles Specification</i>.</p></div>

<hr>
<h2><a name="Property-viewAction">viewAction Property</a></h2>

<p class="section-text"></p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#choice">choice</a> (viewAction)</td></tr>
<tr><td>Since:</td>
<td>2.1</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>View action</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>NoChange</td></tr>
<tr><td>Inherited:</td>
<td>No</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Hidden</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>

<h3>Choices</h3>

<table class="section-table">
<thead><tr><td>Name</td><td>Display Name</td>
<td>Value</td><td>Description</td></tr></thead>
<tbody>
<tr><td>NoChange</td>
<td>No Change</td>
<td>NoChange</td>
<td></td></tr>
<tr><td>Changed</td>
<td>Changed</td>
<td>Changed</td>
<td></td></tr>
<tr><td>Added</td>
<td>Added</td>
<td>Added</td>
<td></td></tr>
<tr><td>Deleted</td>
<td>Deleted</td>
<td>Deleted</td>
<td></td></tr>
</tbody></table><br>

<hr>
<h2><a name="Property-width">width Property</a></h2>

<p class="section-text">Minimum cell width.</p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Type:</td>
<td><a href="../types.html#dimension">dimension</a></td></tr>
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>Required:</td>
<td>No</td></tr>
<tr><td>Display Name:</td>
<td>Width</td></tr>
<tr><td>JavaScript Type:</td>
<td></td></tr>
<tr><td>Default Value:</td>
<td>Cell width will be computed by the table 
or grid based on contents.</td></tr>
<tr><td>Inherited:</td>
<td>Yes</td></tr>
<tr><td>Runtime Settable:</td>
<td>No</td></tr>
<tr><td>Property Sheet Visibility:</td>
<td>Visible</td></tr>
<tr><td>Property Sheet Group:</td>
<td>Top</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p><p>Minimum cell width. Can be an absolute or relative width. 
If omitted, then BIRT or the browser computes the cell width based on content. 
Many users find it more intuitive to set the width on the column, rather than on 
individual cells. The overall column width is the minimum of the column width 
and the width of each cell within the column. All cells are then sized to the 
width of the column.</p>
</p></div>
<h3>See Also</h3>

<div class="section-text">
<p><code>width</code> property of the Column element</p></div>
<h1>Method Detail</h1>

<h2><a name="Method-onCreate">onCreate Method</a></h2>

<p class="section-text">Script executed when the element is created in the Factory.</p>
<h3>Synopsis
</h3>

<p class="section-text"><code>None&nbsp;obj.onCreate(&nbsp;)</code></p>
<h3>Details
</h3>

<table class="detail-table">
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>Context:</td>
<td>factory</td></tr>
<tr><td>Arguments:</td>
<td>None</td></tr>
<tr><td>Return Type:</td>
<td>None</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p>Executed when the element is created in the Factory. Called after the item is created, but before 
the item is saved to the report document file. See the scripting spec for additional information 
about this script. Applications should perform visual customization in the on-render script instead.</p></div>

<hr>
<h2><a name="Method-onPrepare">onPrepare Method</a></h2>

<p class="section-text">It is for a script startup phase. No data binding yet. The design of an element can be changed here.</p>
<h3>Synopsis
</h3>

<p class="section-text"><code>None&nbsp;obj.onPrepare(&nbsp;)</code></p>
<h3>Details
</h3>

<table class="detail-table">
<tr><td>Since:</td>
<td>2.0</td></tr>
<tr><td>Context:</td>
<td>startup</td></tr>
<tr><td>Arguments:</td>
<td>None</td></tr>
<tr><td>Return Type:</td>
<td>None</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p>It is for a script startup phase. No data binding yet. The design of an element can be changed here.</p></div>

<hr>
<h2><a name="Method-onRender">onRender Method</a></h2>

<p class="section-text">Script executed when the element is prepared for rendering in the Presentation engine.</p>
<h3>Synopsis
</h3>

<p class="section-text"><code>None&nbsp;obj.onRender(&nbsp;)</code></p>
<h3>Details
</h3>

<table class="detail-table">
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>Context:</td>
<td>presentation</td></tr>
<tr><td>Arguments:</td>
<td>None</td></tr>
<tr><td>Return Type:</td>
<td>None</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p>Executed when the element is prepared for rendering in the Presentation engine. Changes made to the 
element are written to the target output format, but not saved to the report document file. This is the
preferred place for visual customizations.</p></div>
<h1>Slot Detail</h1>

<h2><a name="Slot-content">content Slot</a></h2>

<p class="section-text">Report items that appear inside the cell.</p>
<h3>Details</h3>

<table class="detail-table">
<tr><td>Display Name:</td>
<td>Content</td></tr>
<tr><td>Since:</td>
<td>1.0</td></tr>
<tr><td>XML Element:</td>
<td>None. (The contents appear directly within the container element.)</td></tr>
<tr><td>Contents:</td>
<td>List of <a href="AutoText.html">AutoText</a>, <a href="Data.html">Data</a>, <a href="ExtendedItem.html">ExtendedItem</a>, <a href="FreeForm.html">FreeForm</a>, <a href="Grid.html">Grid</a>, <a href="Image.html">Image</a>, <a href="Label.html">Label</a>, <a href="Line.html">Line</a>, <a href="List.html">List</a>, <a href="Table.html">Table</a>, <a href="TemplateReportItem.html">TemplateReportItem</a>, <a href="Text.html">Text</a>, <a href="TextData.html">TextData</a></td></tr>
<tr><td>Default Style:</td>
<td>None</td></tr>
</table>

<h3>Description</h3>

<div class="section-text">
<p><p>A cell can contain zero, 
one or more of the following items. The size of the item is defined to be the 
size of the cell. The (x, y) properties of the item are ignored. The normal case 
is one item. When a single item appears in a cell, the items within a row are 
aligned along the text baseline. If multiple items appear within a cell, 
alignment is undefined. Some rendering environments may baseline-align the first 
line, others may not.</p>
<p>When multiple items 
appear within a cell, each item acts a bit like a section: a like break occurs 
after each item, causing the items to be vertically stacked. The user can set 
the &quot;display&quot; property of the items to create an in-line layout: items flow from 
one line to the next with like breaks imposed by the cell width. In-line layout 
applies to the following only:</p>

<ul>
<li>Text (text is treated as a string of text, not a box)</li>

<li>Label</li>

<li>Data item</li>

<li>Image</li>

</ul>
<p>When items appear in-line, an implied space separates the 
items. That is, if a grid has two labels &quot;Sample&quot; and &quot;Labels&quot;, and they are 
marked as in-line, the resulting display is &quot;Sample Label&quot;, not &quot;SampleLabel&quot;.</p>
<p>Alignment within the cell 
is set by the elements themselves. When multiple items appear, each can have a 
distinct horizontal alignment. The set of items as a whole can be vertically 
aligned by setting <i>all</i> items to the same vertical alignment: top, middle, 
base-line or center. (Note the caveat above for base-line alignment.) If the 
multiple items have different vertical alignment, then the behavior is 
undefined. In BIRT-controlled rendering environments, the vertical alignment is 
determined by the first element.</p>
<p>The user can also put 
multiple items in a cell by first adding a container, then adding the other 
items into the container. A container provides greater control over item 
positioning, including enhanced ability to place items side-by-side.</p>
<p></p></p></div>
</body>
</html>
